IviFgen Create Channel Arbitrary Waveform Int32 [AB] VI

IviFgenArbWfmBinary [AB] Capability Group

This VI creates a channel-specific arbitrary waveform and returns a handle that identifies that waveform. Data is passed in as 32-bit binary data. If the arbitrary waveform generator supports formats smaller than 32 bits, read the IviFgen Binary Alignment [AB] property to determine whether to left or right justify the data before passing it to this call.

You pass this handle to the IviFgen Configure Arbitrary Waveform [ARB] VI to produce that waveform. You also use the handles this VI returns to specify a sequence of arbitrary waveforms with the IviFgen Create Arbitrary Sequence [SEQ] VI.

If the instrument does not support channel-based arbitrary waveform creation, use IviFgen Create Arbitrary Waveform VI.

Use the IviFgen Create Channel Arbitrary Waveform Int16 [AB] VI to create a channel-specific arbitrary waveform if you want to pass data in 16-bit binary. Use the IviFgen Create Channel Arbitrary Waveform [ACH] VI to create a channel-specific arbitrary waveform with normalized data.

IviFgen Create Channel Arbitrary Waveform Int32 [AB].vi

instrument handle The instrument handle that you obtain from the IviFgen Initialize or IviFgen Initialize With Options VI.
iivrn instrument handle out The instrument handle that you obtain from the IviFgen Initialize or IviFgen Initialize With Options VI.
channel name ("CHANNEL1") Pass the virtual channel name that you assign to the instrument in the Configuration Utility.

Virtual channel names are aliases for instrument-specific channel strings. The instrument-specific channel strings can differ from one instrument to another. Virtual channel names allow you to use and swap instruments without having to change the channel names in your source code. You assign a virtual channel name to an instrument-specific channel through the Configuration Utility. This control accepts virtual channel names you have assigned to the specific instrument you are using. It also accepts the instrument-specific channel names.

If the instrument has multiple channels, you can pass a comma-separated list of channel names to create multi-channel waveforms.

Default Value: "CHANNEL1"

Note Note  You can specify the channel name as a string variable or as a literal enclosed in double quotes.
waveform data array Specify the array of data you want to use for the new arbitrary waveform. The array must have at least as many elements as the value you specify in the waveform size control.

When you create a multi-channel waveform, this array is the concatenation of the waveform arrays for each channel. In this case, all waveforms must be of the same length.

Default Value: None
ii32 waveform handle Returns the handle that identifies the new arbitrary waveform. Pass this handle to the IviFgen Configure Arbitrary Waveform [ARB] VI to generate the arbitrary waveform. Pass an array of these handles to the IviFgen Create Arbitrary Sequence [SEQ] VI to create an arbitrary sequence.
ci64 waveform size Pass the size of the arbitrary waveform you want to create.

The size must meet the following restrictions:

  • The size is less than or equal to the maximum waveform size the instrument allows.
  • The size is greater than or equal to the minimum waveform size the instrument allows.
  • The size is an integer multiple of the instrument's waveform quantum.

You can obtain these values from the Maximum Waveform Size, Minimum Waveform Size, and Waveform Quantum controls of the IviFgen Query Arb Waveform Capabilities [ARB] VI.

Default Value: None
error in (no error) The error in cluster can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.
ierrcodeclst error out The error out cluster passes error or warning information out of a VI to be used by other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.